home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2004 #6 / Amiga Plus CD - 2004 - No. 06.iso / AmiSoft / Comm / tcp / AmiMSN.readme.txt < prev    next >
Text File  |  1978-04-17  |  7KB  |  203 lines
  1. Short:    (0.5) Major update. MSN Messenger client
  2. Author:   ignorethisbit@mickjt AT ihug.com.au (Michael Trebilcock)
  3. Uploader: ignorethisbit@mickjt AT ihug.com.au (Michael Trebilcock)
  4. Version:  0.5
  5. Type:     comm/tcp
  6. Replaces: util/rexx/AmiMSN*
  7.  
  8. Introduction
  9. ============
  10.  
  11. Well, I was bored one day and decided to look up the MSN Messenger
  12. protocol and write a client for it. Sorry it's all in AREXX, but
  13. I get bored quickly while reading C tutorials.
  14.  
  15. This whole program is a simple experiment to simply prove I could
  16. actually write this in AREXX. Don't expect anything remotely good, I
  17. cannot do a GUI for it because of asynchronousity issues with AWNPIPE.
  18.  
  19. (New to 0.5) HOWEVER. Read below for a nice major update ;)
  20.  
  21. Perhaps this will inspire someone to write a much better client in C.
  22.  
  23. .. or then again, they won't because it's all Microsloth s**t ;)
  24.  
  25. FYI, I hate Microsoft... and they keep changing the protocol without
  26. updating the protocol version.. fkn hell ;)
  27.  
  28.  
  29. Installation
  30. ============
  31.  
  32. Place AmiMSN and AmiMSN-IM.rexx in a directory of your choice,
  33. and edit the AmiMSN.cfg file.
  34.  
  35. The "Allow" option in the .cfg is needed to make sure no outside
  36. access is permitted to AmiMSN's IRCd. Normally keep this at 127.0.0.1
  37. unless you are connecting from a LAN.
  38.  
  39.  
  40. Features
  41. ========
  42.  
  43.  - Asynchronous TCP, read and write at the same time.
  44.  - IRCd mode similar to BitlBee but better IRC compliance.
  45.  - Add/Remove/Rename groups and people on your contact list.
  46.  - List the status of everyone on your contact list.
  47.  - Status sorting (Online users shown first in contact list).
  48.  - Uses automatic adding and privacy settings.
  49.  - Command to save settings/database in a human readable form.
  50.  - TCP stack independant.
  51.  - Communicates directly with the MSN servers, no need for
  52.    a Jabber account or the like.
  53.  - Debug option to save all MSN server I/O to a log file.
  54.  - Communicates in MSNP10 (many other clients use MSNP8).
  55.  
  56.  
  57. History
  58. =======
  59.  
  60. 0.5 (27 May 04):
  61.  
  62.  - DETAILS command fixed. Checking for Automatic adding setting
  63.    was the wrong way around.
  64.  - DETAILS command now shows both group number and group ID.
  65.  - LIST command now shows changes from REMGROUP/ADDGROUP/RENGROUP.
  66.  - Small automatic adding bug fix.
  67.  - No longer requires MiamiNetStat. Found an example non-blocking
  68.    script that uses RxSocket.library, and learnt how to do asynchronous
  69.    arexx from that. This is a major update as Miami(Dx) is no longer
  70.    required to be running.  As a result, conversations will have less
  71.    lag. You can now use this within WinUAE and other emulators with an
  72.    emulated bsdsocket.library.
  73.  - TCP: device is no longer a requirement.
  74.  - Converts unicode characters to ansi in conversations.
  75.  - Debug log file option. Enable by adding Debug = 1 to .cfg file.
  76.  - !! IRC daemon mode !! Read below in Usage for more information.
  77.  - Pings the server every 60 seconds to prevent server from
  78.    disconnecting you after being away for too long.
  79.  - AUTO and PRIVACY command now case-insensitive.
  80.  - Fixed: You can now initiate conversations in rapid succession.
  81.  - Fixed a bug when listing contact list after adding someone
  82.    to it after someone changed their status since you logged on.
  83.    Follow me? heh
  84.  
  85. 0.4:
  86.  
  87.  - Now works with normal AND migrated accounts.
  88.    ^^ If your account is not migrated, you may need to delete
  89.       the AmiMSN.db file and have it re-generated again.
  90.  - LIST now shows people not in a group.
  91.  - Contact list now sorted with people Online shown first.
  92.  - New commands ADDUSER, REMUSER, ADDGROUP, REMGROUP
  93.    RENGROUP, HELP, OUT and RAW
  94.  - Local contact list (LIST) updated after add/remove.
  95.    ^^ Doesn't work with ADDGROUP/REMGROUP/RENGROUP yet.
  96.  - Fixed potential problems when you first connect and
  97.    change a setting or start a conversation before the
  98.    server sends you a challenge ping.
  99.  - More error checking.
  100.  - AmiMSN now compressed into an exe, and configuration
  101.    settings placed in AmiMSN.cfg
  102.  - Fixed small problem with "Lost connection to" before a
  103.    conversation even starts.
  104.  - MiamiNetStat now used every 4 seconds instead of 5.
  105.  - DETAILS command now fixed for people who aren't on
  106.    your FL list.
  107.  
  108. 0.3:
  109.  
  110.  - "On The Phone" & "Out To Lunch" status bugs fixed.
  111.  - Re-coded to work with the newly introduced MSNP10 protocol
  112.  
  113. 0.2:
  114.  
  115.  - "Hidden" status bug fixed
  116.  - Rename your nickname added
  117.  - Checks for MD5SUM, and quits if it cannot find it
  118.  - DETAILS command now reads from memory and saves to file
  119.  - PRIVACY and AUTO commands added
  120.  - Optimizations here and there
  121.  - Nickname is shown when someone goes offline
  122.  - LIST now sorts people into their groups
  123.  - MiamiNetStat is now protected from deletion
  124.  - Usage for REMOVE command fixed
  125.  - Only one MNS.tmp file for all connections
  126.  - Removed unnecessary Say() function in AmiMSN-IM.rexx
  127.  - GTC (aka AUTO) setting now takes affect
  128.  - Invite people into your conversation.
  129.  
  130. 0.1:
  131.  
  132.  - First aminet release
  133.  
  134.  
  135. Todo
  136. ====
  137.  
  138.  - Conversations will stealth re-join when needed
  139.    ^^ Currently this is only done with the IRC interface.
  140.  - Contact list/settings management in IRCd mode.
  141.  - Automatic ANSI<->Unicode charset translation.
  142.  
  143.  
  144. Not Todo
  145. ========
  146.  
  147.  - Avatar support
  148.  - File transfer
  149.  - MSN chat room support
  150.  - Emoticons support
  151.  
  152. * Above is what I DO plan on NOT incorporating ;)) *
  153.  
  154.  
  155. Bugs
  156. ====
  157.  
  158.  - None known.
  159.  
  160.  
  161. Usage
  162. =====
  163.  
  164. When you run AmiMSN, it will connect, and then show a command list.
  165. Type a command to show the usage.
  166.  
  167. AmiMSN can now act as an IRC server. Each group will appear as a
  168. channel, and the contacts in that group will appear as users in
  169. the channel. Opped users are Online. Voiced users are Away or Busy,
  170. and standard users are Offline.
  171.  
  172. To send a message to a contact, just private message them as you
  173. normally would any other user on IRC.
  174.  
  175. To run as an IRC server, type "AmiMSN IRCd", then simply point AmIRC
  176. to server 127.0.0.1 port 6667.
  177.  
  178. This IRC daemon mode provides AmiMSN with some extra features:
  179.  
  180. - Any IRC client can now act as AmiMSN's GUI.
  181. - The WHOIS command shows Idle and Signon times for each contact.
  182. - IRC client features such as sounds can be used, etc..
  183.  
  184.  
  185. Requirements
  186. ============
  187.  
  188. rxsocket.library
  189. rexxdossupport.library
  190. rexxreqtools.library
  191. rexxsupport.library
  192. MD5SUM (requires ixemul.library)
  193.  
  194.  
  195. Glossary
  196. ========
  197.  
  198. (FL) Forward list = People on your contact list
  199. (RL) Reverse list = People who have you on their contact list
  200. (BL) Block list   = People you have blocked from seeing you online
  201. (AL) Allow list   = People who are allowed to see you online
  202. (PL) ? Unknown! Anyone know what this is?
  203.